IdML Connectors for TDI 2.0: Release Notes

--------------------------------------------------------------------------------
 Product Release Information
--------------------------------------------------------------------------------
       
       Product: IdML Connectors for TDI
Release Number: 2.0
  Release Date: 2007/12/20

--------------------------------------------------------------------------------
 Introduction
--------------------------------------------------------------------------------

TDI is a powerful data integration tool, to synchronize and exchange data
among application and directory sources. IdML is an XML schema specification 
used to exchange resource and relationship data across multiple applications. 
These connectors facilitate the use of working with IdML books in TDI.

This release is the second release with significant updates and added features.
Support is provided on a best-effort basis when problems are discovered.

--------------------------------------------------------------------------------
 What's New
--------------------------------------------------------------------------------
	
	- Combined OpenIDML, CloseIDML, and CertifyIDML connectors into OpenIDML
		connector (kept CloseIDML connector as optional)
	- Added IDMLParser connector for reading and parsing IdML books
	- Added support for extended attributes
	- Enhanced reference documentation
	- Added support for book name definition through attribute mapping
	- Added schema query support for IDMLConfigurationItem and IDMLReln
		
--------------------------------------------------------------------------------
 Installation and Upgrade Notes
--------------------------------------------------------------------------------

 System Requirements
 	- TDI v6.1.1+ is installed (in <tdi_install>)
	- TADDM v5.1.1+ SDK is available, either remotely or local. This is the sdk/
	  directory from a TADDM distribution.
 
 Installation (instructions for upgrading from a previous version are further 
 below)
	1) Stop TDI if it is running
	2) Copy IDMLConnectors.jar to jars/connectors/ directory in <tdi_install> 
	   (or any subdirectory under jars/)
	3) Copy api-client.jar, api-dep.jar, and platform-model.jar from 
	   the lib/ directory of TADDM SDK to <tdi_install>/jars/3rdparty/IBM/ 
	   (or any subdirectory under jars/)
	4) Copy dl_core.jar from the dla/dla_utility/ directory of TADDM SDK to 
	   <tdi_install>/jars/3rdparty/IBM/ (or any subdirectory under jars/)
	5) Copy idmlcert.jar and icl.jar from the dla/validator/v2/ directory of 
	   TADDM SDK to <tdi_install>/jvm/jre/lib/ext/
	   
	   Example (Unix) file system:
		/ (root)
		|
		- opt/TDI/jars/
					|
					- 3rdparty/IBM/
								|
								- api-client.jar, api-dep.jar, 
								  platform-model.jar, dl_core.jar
					- connectors/
							|
							- IDMLConnectors.jar
		- opt/TDI/jvm/jre/lib/ext/
								|
								- idmlcert.jar, icl.jar
		      
	6) Start TDI

 Upgrade
 	1) Stop TDI if it is running
 	2) If you replaced the original <tdi_install>/IDILoader.jar file with the 
 	   IDILoader.jar file from a previous release of these connectors, replace 
 	   that file with the original IDILoader.jar file that came with the TDI 
 	   distribution (~24 KB).
 	3) Follow the installation instructions above making sure that there are not 
 	   two copies of any of the jars mentioned under <tdi_install>/jars. Make 
 	   sure that api-client.jar, api-dep.jar, platform-model.jar, dl_core.jar, 
 	   and IDMLConnectors.jar from any old release are over-written by the 
 	   versions for this release. Also make sure that idmlcert.jar and icl.jar 
	   are not located anywhere under <tdi_install>/jars/ but are put in the 
	   proper location as described in the installation notes above.

 Manifest
 	This release consists of the following items:
 	
 		- Release notes (this file)
 		- Connectors binary (jar file)
 		- Getting started guide (ITDI_IDML.pdf)
 		- Component reference guides (html files)
 		
 Version Compatibility
 	The CertifyIDML function component has been removed from this release and 
 	that functionality has been included in the OpenIDML function component. All
 	CertifyIDML function components need to be deleted from all previous 
 	assembly lines that will use this release. To validate your IdML books, open
 	the config parameters tab of the OpenIDML function component and select 
 	'validate' to run validation for your books. This validation will take place
 	when the assembly line is terminated or when a CloseIDML function component 
 	is issued for that book.
 	
--------------------------------------------------------------------------------
 Recent Changes
--------------------------------------------------------------------------------

 	- FEATURE 70154 Allow OpenIdML and CloseIdML to be called multiple times
 	- FEATURE 76396 Runtime input entry to set book name
 	- FEATURE 61114 Implement querySchema in the Connectors
 	- BUG 63753 OpenIDML is crashing if Refresh button is not selected
 	- BUG 64877 Remove the modified IDILoader.jar for the release
 	- BUG 63709 Update the documentation
 	- BUG 65620 TDI's XML parser doesn't read the following element tags 
 		CfgFileName and Value from the XML referenced below.
 	- BUG 65621 CertifyIdML not catching all problems
 	- BUG 70555 Validate IdML is broken in the new release
 	- BUG 70561 IdMLConfiguration is too verbose
 	- BUG 72940 Book name attribute isn't available through OpenIDML
 	- BUG 73045 No way to close IdML book before end of AL execution
 	- BUG 73031 No reference guides exist for components
 	- BUG 77542 querySchema does not work for IDMLConfigurationItem
 	
--------------------------------------------------------------------------------
 Known Problems and Workarounds
--------------------------------------------------------------------------------

 There are no known problems at this time.
 